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Copyright 

*> Copyright 1982, 1985. Apple Computer. Inc. lor 
all nontextual material, graphics, figures, 
photographs, and all computer program listings 
or code in any form, including object and source 
code. All rights reserved. 

For some products, a multi-use license may be 
purchased to allow the software to be used on 
more than one computer owned by the 
purchaser, including a shared-disk system. 
(Contact your authorized Apple dealer for 
information on multi-use licenses.) 

Apple and the Apple logo are trademarks of 
Apple Computer, Inc. 

Printed in Singapore. 



Limited Warranty on Media 
and Replacement 

If you discover physical defects in the manuals 
distributed with an Apple product or in the media 
on which a software product is distributed, Apple 
will replace the media or manuals at no charge to 
you. provided you return the item to be replaced 
with proof of purchase to Apple or an authorized 
Apple dealer during the 90-day period after you 
purchased the software. In addition. Apple will 
replace damaged software media and manuals 
for as long as the software product is included In 
Apple's Media Exchange Program. 

While not an upgrade or update method, this 
program offers additional protection for up to 
two years or more from the date of your original 
purchase. See your authorized Apple dealer for 
Program coverage and details. In some countries 
the replacement period may be different; check 
with your authorized Apple dealer. 

ALL IMPLIED WARRANTIES ON THE MEDIA 
AND MANUALS, INCLUDING IMPLIED 
WARRANTIES OF MERCHANTABILITY AND 
FITNESS FOR A PARTICULAR PURPOSE, ARE 
LIMITED IN DURATION TO NINETY (90) DAYS 
FROM THE DATE OF THE ORIGINAL RETAIL 
PURCHASE OF THIS PRODUCT. 



Even though Apple has tested the software and 
reviewed the documentation. APPLE MAKES NO 
WARRANTY OR REPRESENTATION, EITHER 
EXPRESS OR IMPLIED, WITH RESPECT TO 
SOFTWARE. ITS QUALITY, PERFORMANCE, 
MERCHANTABILITY, OR FITNESS FOR A 
PARTICULAR PURPOSE. AS A RESULT, THIS 
SOFTWARE IS SOLD "AS IS," AND YOU THE 
PURCHASER ARE ASSUMING THE ENTIRE 
RISK AS TO ITS QUALITY AND 
PERFORMANCE. 

IN NO EVENT WILL APPLE BE LIABLE FOR 
DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR 
CONSEQUENTIAL DAMAGES RESULTING 
FROM ANY DEFECT IN THE SOFTWARE OR ITS 
DOCUMENTATION, even if advised of the 
possibility of such damages. In particular, Apple 
shall have no liability for any programs or data 
stored in or used with Apple products, including 
the costs of recovering such programs or data. 

THE WARRANTY AND REMEDIES SET FORTH 
ABOVE ARE EXCLUSIVE AND IN LIEU OF ALL 
OTHERS, ORAL OR WRITTEN, EXPRESS OR 
IMPLIED. No Apple dealer, agent, or employee is 
authorized to make any modification, extension, 
or addition to this warranty. 

Some states do not allow the exclusion or 
limitation of implied warranties or liability for 
incidental or consequential damages, so the 
above limitation or exclusion may not apply to 
you. This warranty gives you specific legal rights, 
and you may also have other rights which vary 
from state to state. 



Warning 

This equipment has been certified to comply with 
the limits for a Class B computing device, 
pursuant to Subpart J of Part 15 of FCC Rules. 
Only peripherals (computer input/output devices, 
terminals, printers, etc.) certified to comply with 
the Class B limits may be attached to this 
computer. Operation with non-certified 
peripherals is likely to result in Interference to 
radio and TV reception. 

Reorder Apple Product #A2L2007 
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Radio and Television Interference 

The equipment described in this manual generates and uses radio- 
frequency energy. If it is not installed and used properly, that is. In 
strict accordance with our instructions, it may cause interference 
with radio and television reception. 

This equipment has been tested and complies with the limits for a 
Class B computing device in accordance with the specifications in 
Subpart J. Part 15. of FCC rules. These rules are designed fo 
provide reasonable protection against such interference in a 
residential installation. However, there is no guarantee that the 
interference will not occur in a particular installation, especially if 
you use a "rabbit ear" television antenna. (A "rabbit ear" antenna is 
the telescoping -rod type usually contained on TV receivers) 

You can determine whether your computer is causing interference 
by turning It off. If the interference stops, it was probably caused 
by the computer or its penpheral devices. To further isolate the 
problem: 

• Disconnect the peripheral devices and their input/output cables 
one at a time. If the interference stops, it is caused by either 
the peripheral device or its I/O cable. These devices usually 
require shielded I/O cables For Apple peripheral devices, you 
can obtain the proper shielded cable from your dealer. For non- 
Apple peripheral devices, contact the manufacturer or dealer 
for assistance. 

If your computer does cause interference to radio or television 
reception, you can try to correct the interference by using one or 
more of the following measures; 

• Turn the TV or radio antenna until the interference stops. 

• Move the computer to one side or the other of the TV or radio. 

• Move the computer farther away from the TV or radio. 

• Plug the computer into an outlet that is on a different circuit 
than the TV or radio. (That is. make certain the computer and 
the radio or television set are on circuits controlled by different 
circuit breakers or fuses.) 

• Consider installing a rooftop television antenna with coaxial 
cable lead-m between the antenna and TV, 
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If necessary, you should consult your dealer or an experienced 
radio/television technician tor additional suggestions. You may find 
helpful the following booklet, prepared by the Federal 
Communications Commission: 

"How to Identify and Resolve Radio-TV Interference Problems" 

This booklet is available from the U.S. Government Printing Office, 
Washington. DC 20402. stock number 004-000-00345-4. 
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Preface 



Who Needs To Read This 
Supplement? 



This supplement comes with the Apple lie Extended 80-Column 
Text Card and describes the added features it has. compared to 
the 80-Column Text Card. Before reading this supplement, you 
should read the Apple lie 80-Column Text Card Manual. 

There are two ways you are likely to use the extended version of 
the 80-Column Text Card: 

• As a user with application programs that take advantage of the 
extra memory on the card to give you more features or more 
storage for your data. 

• As a developer creating a program, for yourself or for others, 
that will use the extra storage the extended card provides. 

Users; A Card Is a Card 

From the user's point of view, the Extended 80-Column Text Card 
is Just like the standard 80-Column Text Card Oh. it's a little 
bigger, and it costs more, but the technical differences between 
the two kinds of text cards are mostly hidden by software. Read 
Chapter 1 of this supplement for an introduction to the Apple lie 
80-Column Extended Text Card. 

The extended text card is installed the same way as the standard 
80-column card: read the Apple lie 80-Column Text Card Manual 
for directions. 
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Most application programs run the same with either card— In fact, 
many of them don't even take advantage of the extra memory on 
the extended card: they simply use it to display 80 columns of 
text. Programs that do use the extra memory may do so 
automatically, without any action on your part, or they may let you 
select optional features or data storage. To find out how to use 
those programs with the extra memory, refer to their instruction 
manuals. 

In short, if you just want to use this card for displaying 80 columns 
of text, and you aren't developing a program that uses the auxiliary 
memory, all you really need to know can be found in the Apple lie 
80-Column Text Card Manual and in the instructions for your 
application programs. 

Developers: How To Use the Auxiliary 
Memory 

The only difference between the Extended 80-Column Text Card 
and the standard 80-Column Text Card is the amount of memory 
they contain. The extended card has 64K bytes of auxiliary 
memory, while the standard card has only the additional 1 K bytes 
necessary to display 80 columns of text on an Apple lie. 

The main purpose of this supplement is to provide you with enough 
information to use the auxiliary memory in your programs. Normally, 
programs used with the Apple lie can only work with the 64K bytes 
of built-in main memory To work with the auxiliary memory, a 
program must set special switches In the Apple lie that substitute 
auxiliary memory for main memory. Neither DOS 3.3 nor Pascal 
1 1— system programs for the Apple II — support this memory 
substitution, so for now your application programs have to handle it 
themselves. 

Contents of This Supplement 

This supplement contains the information you need to use the 
auxiliary memory for storing programs and data. Chapter 1 is a 
general introduction; it describes the functions of the Extended 
80-Column Text Card. 

Chapter 2 is a general description of the design of the Extended 
80-Column Text Card; it explains how the card works with the 
Apple lie hardware. 
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Chapter 3 contains directions for using the auxiliary memory with 
your programs. Most of the information in Chapter 3 is adapted 
from the Apple lie Reference Manual The reference manual is your 
mam source of information about the internal operation of the 
Apple lie. 

Chapter 4 contains short programs that use the auxiliary memory. 
These examples are functional, but not general: you will probably 
want to modify them for use in the programs you write. 

Symbols Used in This Supplement 

Special text in this manual is set off in different ways, as shown in 
these examples. 

Warning 

Important warnings appear (n boxes tike this 



Reminder: Information that is only incidental to the text appears in gray 
boxes like this You may want to skip over such boxes and return to 
them later. 



Captions, definitions, and other short 
Moms appear m marginal glosses like 

IN* 
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Introduction 



The design of the Apple lie Extended 80-Column Tex! Card is the 
same as that ot the standard Apple lie 80-Column Text Card. The 
only difference is that the extended text card contains 64K bytes 
ot auxiliary memory (programmable memory or RAM) while the 
standard card contains only 1 K byte ot RAM The 80-column 
display requires only 1 K byte of auxiliary memory, so it will work 
with either card. The firmware that supports the special features 
associated with the 80-column display is part of the Apple lie itself, 
and works the same regardless ot which card is present 

Installation 

Installing the Extended 80-Column Text Card is easy do it just the 
way you install the standard 80-Column Text Card Either card fits 
into the auxiliary slot (labeled aux. connector) on the main logic 
board inside the Apple He. If you haven't installed the card yet, 
follow the directions given in the Apple He 80-Column Text Card 
Manual. 



Warning 

Never install or remove anything inside the Apple He with the power on. 
There is a small red lamp— an LED— toward Ihe back ot the main circuit 
board to remind you of this; if the red lamp is on, turn off the power 
before you do anything inside the Apple lie. 
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80-CoIumn Features 

The built-in firmware that supports the 80-column display has other 
features in addition to the wider display. The Apple He 80~Column 
Text Card Manual tells you how to activate the built-in firmware and 
the 80-column display. That manual also describes many of the 
Apple lies features. 

You can find more information about the Apple He in the Apple He 
Reference Manual, Chapter 2 includes a description of the different 
display modes and how to select them. Chapter 3 includes tables 
of the functions of the escape sequences and control keys in the 
Apple He. 

About the Auxiliary Memory 

The Extended 80-Column Text Card has 64K bytes of additional 
RAM, usually referred to as auxiliary memory, A 1K-byte area of 
this memory serves the same purpose as the memory on the 
80-Column Text Card: expanding the text display to 80 columns. 
The other 63K bytes can be used for auxiliary program and data 
storage. If you use only 40 columns for text display, all 64K bytes 
are available for programs and data. 

The processor m the Apple lie can only address 64K bytes of 
memory. The computer has special circuits that programs can 
switch to access auxiliary memory in place of main memory. At any 
one time, locations m the same 64K address space are in either 
main memory or auxiliary memory. In other words, even though an 
Apple lie with an Extended 80-Column Text Card has a total of 
128K bytes of programmable memory, it is not appropriate to call it 
an 128K-byte system. Rather, there are 64K bytes of auxiliary 
memory that can be swapped for main memory under program 
control. 



Warning 

Careless switching to the auxiliary memory is almost certain lo crash 
your programs If you want to use auxiliary memory in your own 
programs, be sure to study the rest of this supplement and the relevant 
information in the Apple lie Reference Manual 
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Chapter 2 



How the Auxiliary Memory 
Works 



This chapter briefly outlines how the auxiliary memory operates. It 
will help you understand what happens when you use the auxiliary 
memory in your programs. 

Addressing the Auxiliary Memory 

The 6502 microprocessor can address 64K bytes of memory In 
the Apple lie the microprocessor's entire 64K memory space is 
taken up by main RAM (random-access memory), ROM (read-only 
memory), and I/O (input output); there's no memory space available 
tor the added memory on the extended text card. Instead, the 
address bus is connected to the auxiliary memory in parallel with 
the main memory. To use the auxiliary memory lor program and 
data storage, the Apple He switches its data bus so that it reads 
and writes to the memory on the card instead of the main memory. 
To use the auxiliary memory to expand the display, the Apple lie 
fetches data both from main memory and from auxiliary memory, as 
described in the section "How the 80-Column Display Works," 

The bus switching for program and data storage is controlled by 
the Memory Management Unit (MMU), a custom integrated circuit 
designed for the Apple lie (see Chapter 7 of the Apple lie 
Reference Manual). The MMU contains the soft switches set by 
your programs along with the logic circuitry to monitor the address 
bus and to switch to auxiliary memory for the selected address 
ranges. 
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As you can see by studying the memory map in Figure 2-1 . the 
auxiliary memory is divided into two large sections and one smalt 
one. The largest section is substituted for main memory addresses 
512 to 49151 (J200 through $bp ff). This part of memory is 
sometimes referred to as the 48K memory space, and it is used for 
storing programs and data. 

The other large section of auxiliary memory replaces main memory 
addresses 52k to 64K ($0000 through sffff). This memory space 
is called the bank-switched memory. If you plan to use this part of 
the auxiliary memory, read the section "Bank-switched Memory' 1 in 
the Apple lie Reference Manual. The switching for the ROM and 
the $0000 bank is independent ot the auxiliary-RAM switching, so 
the bank switches have the same effect on the auxiliary RAM that 
they do on the main RAM- 

When you switch to the auxiliary memory in the bank*switched 
memory space, you also get the first two pages of auxiliary 
memory, from to 511 ($0000 through $01 FF). This part of 
memory contains page zero, which is used for important data and 
base addresses, and page one, which is the 6502 stack. 



Warning 

Remember that addresses in page zero and the 6502 stack switch lo 
auxiliary memory any time you switch Ihe Dank-switched memory to 
auxiliary memory. 



How the 80-Column Display Works 

Half of the data 'or the 80-column display ts stored in mam memory 
in the normal text Page 1 , and the other half is stored in auxiliary 
memory on the extended text card The display circuitry fetches 
bytes of data from these two memory areas simultaneously and 
displays them as two adjacent characters. 



Memory pages are 256 byte^ long, Oul 
display pages are either 1024 byies. 
eg. text Page 1, or 8192 byies, e.g.. 
high-resolution graphics Page i See 
Chapters 2 and 4 ol ihe Apple lie 
RQfQtence Manual 



The main memory and the auxiliary memory are connected to the 
address bus in parallel, so both are activated during the display 
cycle. The 40-column display uses every other clock cycle and 
fetches data only from main memory. The 80-column display uses 
the remaining clock cycles lo process Ihe additional display data 
from auxiliary memory. 
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Figure 2*2, Fetching Data for the 
80-Cohimn Osptay 
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The byte of display dala from main memory goes to a butter on the 
main logic board, and the display data from auxiliary memory goes 
to a buffer on the extended text card. When the 80-column display 
is on. the data bytes from these buffers are switched onto the 
video data bus on alternate clock cycles: first the byte from the 
auxiliary memory, then the byte from the main memory. The main 
memory provides the characters displayed in the odd columns of 
the display, and the auxiliary memory provides the characters in the 
even columns. 

The 80-column display contains twice as many characters as the 
40-column display does, so it has to put twice as many dots across 
the screen. This means that the dots are clocked out at 14MHz 
instead of 7MHz, making them narrower and therefore dimmer on a 
normal video monitor. On a television set. the dot patterns making 
up the characters are too close together to reproduce clearly. To 
produce a satisfactory 80-column display requires a monitor with a 
bandwidth of at least 14MHz 
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RGB stands for red. green, and ttue. 
and identifies a Type of color monitor 
that uses independent inputs tor the 
three primary cokxs 



Except lor some expensive RGB-type color monitors, any video monitor 
with a bandwidth as high as 14MHz will be a monochrome monitor 
Monochrome means one color, a monochrome video monitor can have 
a screen color ol white, green, orange, or any other single color. 



Note that this simultaneous-then-sequential fetching applies only to 
the video-display generation; reading and writing for data storage in 
auxiliary memory is done by switching the data bus to read only 
from the card, as described in the previous section For more 
information about the way the Apple He handles its display memory, 
refer to Chapter 2 and Chapter 7 ol the Apple He Reference 
Manual 

Double High-Resolution Graphics 

When you select mixed-mode graphics with 80-column text, you 
would expect that the doubling of the data rate that produces the 
80-column display would change the high -resolution graphics from 
280 to 560 dots horizontally and cause the low- resolution graphics 
to malfunction. To prevent this, the logic that controls the display 
includes an extra circuit to force the graphics displays to be the 
same regardless of whether you have set the soft switches lor 
80-column text or for 40-column text. This feature is included so 
that you can use 80-column text in the mixed graphics and text 
modes. 

For those who would like lo have a graphics display with twice the 
horizontal resolution, there is a way to disable the circuit that lorces 
normal graphics timing with 80-column text. There are two things 
you must do to obtain the double high-resolution display: 

• Install a jumper to connect the two Molex-type pins on the 
Extended 80-Column Text Card. 

• Turn on the Annunciator 3 soft switch along with the switches 
that select the 80-column display and high-resolution graphics- 

This procedure works only on the Apple He with the Rev B (and 
later) main logic board, identified by a B as the last letter of the part 
number on the back part of the board Connecting the pins on the 
Extended 80-Column Text Card completes a connection between 
pin 50 (AN3) and pin 55 (frctxt') on the auxiliary slot 
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Warning 

if you have a Rev A Apple lie. using an extended text card wllh a 
jumper makes Ihe computer inoperable You cannol use the double 
high- resolution modification with a Rev A Apple He. 

II you have an extended text card wilh a jumper installed in a Rev B 
(or later) Apple He. turning on Annunciator 3 and selecting high- 
resolution graphics and 80-column text at the same time generates 
a display using high-resolution Page 1 addresses in main memory 
and auxiliary memory at the same time. 

The memory mapping lor this graphics display is doubled by 
columns the same way as 80-column text, but it uses high- 
resolution graphics Page 1 instead of text Page 1 . Where the 
80-column text mode displays pairs of data bytes as pairs ol 
characters, double high- resolution mode displays pairs of data 
bytes as 14 adjacent dots, seven from each byte. As in 80-column 
text mode, there are twice as many dots across the display screen, 
so the dots are only half as wide. 

Existing Apple II graphics programs do not support this kind of 
display Until new programs become available, you'll have to write 
your own plotting routines if you want to use 560-dot graphics. 
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Chapter 3 



How To Use the Auxiliary 
Memory 



This chapter describes soft switches and built-in subroutines that 
control the operation of the auxiliary memory. To take advantage of 
the additional memory, you must set up your programs to operate 
tn one part ot memory while they switch the other part between 
main and auxiliary RAM. Your program can perform the memory 
switching by means of the soft switches described in the section 
'Display Mode Switching'* or by using the auxhove and xfer 
subroutines described later in this chapter. Except for these 
subroutines, most existing Apple II system software (DOS 3,3, 
Pascal 1.1 J doesn't support the auxiliary memory. 

Although some high-level languages, such as BASIC, can set the 
soft switches directly, your programs must use assembly-fanguage 
subroutines to control the auxiliary memory. Small assembly- 
language subroutines can be accessed from a BASIC program 
using a call statement, or they can be linked to a Pascal program 
as procedures or functions: see the examples in Chapter 4. 



Warning 

Do no! attempt to use the auxiliary memory directly from a program in 
an interpreter language such as BASIC or Pascal. The interpreters that 
run such programs use several areas In main memory, including the 
stack and the zero page. II you switch to auxiliary memory in these 
pages, the Interpreter crashes* When you reset the system to start 
over, your program and data are lost. 
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The Extended Display 

The primary purpose of an 80-column text card is the generation of 
an 80-column display, so there is a complete set of switches just 
lo control the display. Other switches are used for program and 
data storage in the auxiliary memory; they are described later, 

Display Pages 

The Apple He generates its video displays from data stored in 
specific areas in memory called display pages The 40-columrvtext 
and low-resolution-graphics modes use text Page 1 and text 
Page 2, located at 1024-2047 (hexadecimal *400-$7ff) and 
2048-3071 (S800-SBFF) in main memory. 

The 80-column text display uses a combination of text Page 1 in 
main memory and the same page in the auxiliary memory, here 
called Page 1X. Text Page 1X occupies the same address space 
as text Page 1 , but in auxiliary memory rather than main memory. 
To store data in Page 1X f you must use a soft switch (see the 
section "Display Mode Switching* 1 ). The built-in 80-column display 
routines described in Chapter 3 ot the Apple He Reference Manual 
take care of this switching automatically; that is a good reason to 
use those routines for all your normal 80-column text output 



Table 3-1. Video Drsplay Page 
Locations. *Note: These modes use 
locations in both main and auxifcar y 
memory The PAGE2 switch is used to 
select one or the other tor storing data 
see the section "Display Mode 
Switching." 



Display Mode 


Page 


Lowest 
Address 


Highest 
Address 


Notes 


40-Column Text. 
Low * Resolution 
Graphics 


i 
2 


$4 00 1024 
$600 204B 


$7FF 2047 
$BFF 5071 




BOColumn Text 


1 


S400 1024 


$7FF 2047 


i 


Normal 280-Dot 
High-Resolution 
Graphics 


1 
2 


$2000 8192 

$4000 1 6354 


S3FFF 16383 
J5FFF 24575 




Optional 560- Dot 
High Resolution 
Graphics 


1 


$2000 8192 


S3FFF 16383 


• 
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For information about the keyboard data 
and strobe (unctions, see Chapter 2 ol 
the Aople lie Reference Manual 



Display Mode Switching 

You select the display mode that is appropriate (or your application 
by reading or writing to soft switches. Most sott switches have 
three memory locations; one for turning the switch on, one tor 
turning it off. and one tor reading the state of the switch. 

Table 3-2 shows the locations of the soft switches that control the 
display modes. The table gives the switch locations in three forms: 
hexadecimal, decimal, and negative decimal. You can use the 
hexadecimal values in your machine-language programs Use the 
decimal values in peek or poke commands in Applesoft BASIC; the 
negative values are for Integer BASIC. 

Some of the soft switches in Table 3-2 are marked read or write. 
Those soft switches share their locations with the keyboard data 
and strobe functions. To perform the function shown in the table, 
use only the operation listed there. Soft switches that are not 
marked may be accessed by either a read or a write. When writing 
to a sott switch, it doesn't matter what value you write; the switch 
function occurs when you address the location, and the value is 
ignored. 



Warning 

Be sure to use only the indicated operations to manipulate the 
switches. II you read from a swilch marked write, you won't get the 
correct data. If you write to a swilch marked read, you won't set the 
switch you wanted, and you may change some other switch so as to 
cause your program to malfunction. 



When you read a soft switch, you get a byte with the state of the 
switch in bit 7, the high-order bit The other bits in the byte are 
unpredictable. If you are programming in machine language, this bit 
is the sign bit. If you read a soft-switch from a BASIC program, you 
get a value between o and 255. Bit 7 has a value of 1 28, so it the 
switch is on. the value will be equal to or greater than 1 28; if the 
switch is oft, the value will be less than 128. 
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Table 3-2. Display Soft Switches (1) 
This mode is onfy effective when TEXT 
switch cs oft (2) This switch has a 
dtflocent function when B0ST0RE ts on 
refer to the next section )3) This switch 
changes the function ol the PAGEZ 
switch iot addressing the display 
memory on the extended text card: 
refer to the next section. 



Nime Function 



text On Display Text 

Off Display Graphics 
Read text Switch 

MIXED On Text With Graphics 
Off Full Graphics 
Read MIXED Switch 

PAGE2 On Display Page 2 

Off Display Page 1 
Read PAGE2 Switch 

hires On. Graphics = High- 
Resolution 

Off Graphics ■ Low- 
Resolution 

Read HIRES Switch 

80C0L On Display 60 Columns 
Off Display 40 Columns 
Read 80COL Switch 

BOSTORC On Store in Auxttary Page 
Off Store in Main Page 
Read 8QST0RE Switch 



Location 

He* Decimal 




Noles 


*C05i 
SC050 
4C01A 


49233 
49232 
49178 


-16303 
-16304 
-16358 


Read 


1C053 
SC052 
SC01B 


49235 
49234 
49179 


-16101 
-16302 
-16357 


1 
1 
Read 


SC055 
SC054 

4C0U 


49237 

49236 
49180 


-16299 

-16300 
-16356 


2 
2 

Read 


SCQ57 


49239 


-16297 


1 


SC056 
SC01D 


49238 
49181 


-16298 
-16355 


1 
Read 


1C00D 
SCOOC 
*C01f 


49165 
49164 
49183 


-16371 
-16372 
-163S3 


Write 
Write 
Read 


IC001 

scooo 
f cot s 


49153 

49152 
49176 


-16383 

-16384 
-16360 


Wnie.3 
Write, 3 
Read 



Addressing the 80-Column Display Directly 

Figure 3-1 is the map of the 80-column display. Halt of the data is 
stored in text Page 1 in main memory, and the other half is stored 
in the same locations In auxiliary memory (here called Page 1X). 
The display circuitry fetches bytes from these two memory areas 
simultaneously and displays them sequentially; first the byte from 
the auxiliary memory, then the byte from the main memory. The 
main memory stores the characters in the odd columns of the 
display, and the auxiliary memory stores the characters in the even 
columns. For a full description of the way the Apple lie handles its 
display memory, refer to Chapter 2 and Chapter 7 of the Apple lie 
Reference Manual. 
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To store data directly into the display page on the Extended 
80-Column Text Card, first turn on the bostore soft switch by 
writing to location 491 53 (negative decimal -1 6583 or hexadecimal 
SC001). With bostore on. the page-select switch PAGE2 switches 
between the portion ot the 80-column display stored in Page 1 of 
main memory and the portion stored in Page 1 X in auxiliary 
memory. To select Page IX, turn the page 2 soft switch on by 
reading or writing at location 49237 (-16299. 1C055). 

You'll have to write a short program to try out the BOSTORE and 
PAGE2 soft switches. When you try to change these switches by using 
the Monitor program, it changes them back in the process ol displaying 
the commands you type. 

If you want to use the optional double-high-resolution display 
described in Chapter 2, you can store data directly into high- 
resolution graphics Page 1X in auxiliary memory in a similar fashion. 
Turn on both bostore and hires, then use PAGE2 to switch from 
Page 1 in main memory to Page IX in auxiliary memory. 

The memory mapping for double high-resolution graphics is similar 
to the normal high-resolution mapping described in Chapter 2 of the 
Apple lie Reference Manual, with the addition of the column 
doubling produced by the 80-column display Like the 80-column 
text mode, the double high-resolution graphics mode displays two 
bytes in the time normally required for one. but it uses high- 
resolution graphics Page 1 and Page 1 X instead of texl Page 1 and 
Page 1X. 



For a description ol the way the high- 
order bll acts as color-select bit in 
high-resolution displays, see Chapters 2 
and 7 ol the Apple lie Reference 
Manual. 



Double high-resolution graphics mode displays each pair of data 
bytes as 14 adjacent dots, seven from each byte. The high-order 
bit (color-select bit) of each byte is ignored. The auxiliary-memory 
byfe is displayed first, so data from auxiliary memory appears in 
columns 0-6. 14-20, etc., up to columns 547-552. Data from main 
memory appears in columns 7-13. 21-27, and so on up to 
553-559. 



As in 80-column text, there are twice as many dots across the 
display screen, so the dots are only half as wide. On a TV set or 
low-bandwidth monitor, single dots will be dimmer than normal. 
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Figure 3-1, Map of 60 -Column Text 
Dtsptay 



MAIN 
MEMORY 



100 SOI $02 103 $04 105 106 
1 2 3 4 5 6 



AUXILIARY $00 SOI S02 $03 $04 $05 $06 $07 

MEMORY 1 7 3 4 5 6 7 



149 14 A 14 1 14C $40 14 E *4F 

73 74 75 7* 77 70 79 

$49 S4A $4B S4C $4D $4E $4F 

73 74 75 76 77 76 79 



$400 

$480 

$500 

$560 

$600 

$680 

$700 

$760 

$428 

$4A8 

$526 

S5A8 

$628 

$6A8 

$726 

$7A8 

$450 

$400 

$550 

$500 

$650 

$600 

$750 

S7DC 



10?4 
1152 
1260 
1406 
1536 
1664 

1792 
1920 
1064 
1192 
1320 
1448 
1576 
1704 
1632 
1960 
1104 
1232 
1360 
1466 
1616 
1744 
1872 
2000 



:::::: ::::::: 
::::::::::::::::: 
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When R*MWBT and ramrd are on. 
auxrfiary momory is used, when they ate 
off, main metntxy is used 



Auxiliary Memory Switching 

This section describes the switches used to access the auxiliary 
memory for storing programs and data. 



Warning 

The display soft switches 80STORE. PAGE2. and HIRES, discussed 
here and in the previous section, are used primarily for addressing 
display data. These switches override the general-purpose switches 
described in this section, so you must set them correctly even if your 
program doesn't use them. 



Switching the 48K Bank 

Switching the 48K-byte section ot memory is performed by two 
sott switches: ramrd selects main or auxiliary memory for reading, 
and rahuri selects main or auxiliary memory for writing. As shown 
in Table 3-3, each switch has a pair of memory locations dedicated 
to it, one to select mam memory, and the other to select auxiliary 
memory. Setting the read and write functions independently makes 
it possible for a program whose instructions are being (etched from 
one 48K-byte memory space to store data into the other 48K 
memory space. 



Warning 

Belore using these switches, you must tully understand the effects of 
switching to auxiliary memory. For example, an application program 
running in the 48K bank ol auxiliary memory that tries to use the built-in 
10 routines by calling the standard 10 links will crash even though the 
main ROM, which contains the built-in |;0 routines, has been selected 
This happens because the standard links call DOS routines, and DOS is 
in the 48K bank of main memory, which is locked out while the 
application program is running in auxiliary memory. 

Writing to the soft-switch at location SC003 turns rahro on and 
enables auxiliary memory for reading; writing to location SC002 
turns ramrd ott and enables main memory for reading. Writing to 
the soft-switch at location 1C005 turns rahwrt on and enables the 
auxiliary memory (or writing; writing to location scoot turns ramwrt 
off and enables main memory for writing. By setting these switches 
independently, you can use any of the four combinations of reading 
and writing in main or auxiliary memory. 
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Auxiliary memory corresponding to text Page 1 and high-resolution 
graphics Page l can be used as part of the 48K bank by using 
ramrd and ramwrt. These areas in auxiliary memory can also be 
controlled separately by using the display-page switches bostore, 
page 2. and hires described in "Addressing the 80-Column 
Display Directly." 

As shown in Table 3-3. the sostore switch functions as an 
enabling switch: with it on, the page? switch selects main memory 
or auxiliary memory. With the hires switch off, the page? switch 
selects main or auxiliary memory in the text display Page 1 , S0400 
to S07FF. with hires on. the page 2 switch selects main or 
auxiliary memory in text Page 1 and high-resolution graphics 
Pagel. S2000 to $3fff. 

If you are using both the 48K-bank control switches and the 
display-page control switches, the display-page control switches 
take priority, if bostore is oft. ramrd and ramwrt work for the 
entire memory space from $0200 to sbfff. but if bostore is on, 
ramrd and ramurt have no effect on the display page 
Specifically, if BOSTORE is on and hires is off. PAGE2 controls text 
Page 1 regardless of the settings of ramrd and ramwrt. Likewise, 
if 80STORE and hires are both on. page2 controls both text 
Page 1 and high-resolution graphics Page 1. again regardless of 
ramrd and ramwrt. 

You can find out the settings of these soft switches by reading 
from two other locations. The byte you read at location scoi3 has 
its high bit (the sign bit) set to 1 it ramrd is on (auxiliary memory is 
enabled for reading), or o if ramrd is off (the 48K block of main 
memory is enabled for reading). The byte at location scoi 4 has its 
high bit set to 1 if ramwrt is on (auxiliary memory is enabled for 
writing), or If ramwrt is off (the 48K block of main memory is 
enabled for writing). 
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Figure 3-2. Effect of Switching RAMRD 
and rahwrt with SOstorc Ofl 
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Figure 3-3, EHect ol Switching RAHRD 
and ranurt with SOSTORE and hires 
On 
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When ihe A u t z p sofl swilch is on. 
auxiliary memory is used, when it is oil. 
main memory is usefl 



Switching High Memory, Stack, and Zero Page 

The single sott switch altzp (alternate zero page) switches the 
bank-switched memory and the associated stack and zero page 
area between main and auxiliary memory. As shown in Table 3-3, 
writing to location sr.009 turns altzp on and selects auxiliary- 
memory stack and zero page: writing to the soft switch at location 
*C008 turns altzp off and selects main-memory stack and zero 
page for reading and writing. The section Auxiliary- Memory 
Subroutines" describes firmware that you can call lo help you 
switch between mam and auxiliary memory. 

To find out the setting of this soft switch, read location *C016. The 
data byte you get has its high bit (the sign bit} set to 1 if altzp is 
on (the bank-switched area, slack, and zero page in the auxiliary 
memory are selected), or o if altzp is oft (the same areas in main 
memory are selected). 

To have enough memory locations lor all ot the soft switches and 
remain compatible with the Apple II and Apple II Plus, the soil switchos 
listed in Table 3-3 share their memory locations wilh the keyboard 
functions listed in Chapter 2 ot the Apple lie Reference Manual. 
Whichever operation— read or wnte— is shown in Table 3-3 for 
controlling the auxiliary memory is the one that is not used lor reading 
the keyboard and clearing Ihe strobe- 
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Table 3-3- Auxiliary -Memory Selecl 
Switches. (1) When SOSTOftE is on. the 
PAGE? switch works as shown, when 
aosrone isott, page? doesn't aHect 
the auxiliary memory. (2) When 
flO STORE is on, the HIRES switch 
enabtes you to use the page? switch to 
select between hiQhresoJution Page 1 
in main and auxltary memory. 







Location 






Name 


Function 


Hex 


Decimal 




Notes 


RAMRD 


On Read Auk. 48K 


SC003 


49155 


-16381 


Write 




OH Road Mam 48K 


*C002 


49154 


-16382 


Wnte 




Read RAMRO Switch 


SCQ13 


49171 


-16365 


Read 


RAHWRT 


On Wnie Auk 48K 


IC005 


49157 


-16379 


Wnte 




Oil: Wnte Main 48K 


SC004 


49156 


-16380 


Write 




Read rahuht Switch 


SC014 


49172 


-16354 


Read 


ALTZP 


On. Auk Stack. Zero 
Page, and Bank- 












Switched Memory 


SC009 


49161 


-16373 


Write 




Off: Mam Stack. Zero 












Page, and Bank- 












Switched Memory 


1C009 


49160 


-16374 


Write 




Read A i T z P Switch 


SC016 


49174 


-16352 


Read 


80STORE 


On; Access Page IX 


S C 1 


49153 


-16383 


Wnte 




Off: Use rahro, rahwrt 


scooo 


49153 


-16384 


Write 




Road 80ST0RE Swtich 


SC018 


49176 


-16360 


Read 


PACE? 


On: Access Auk. Memory 


SC055 


49237 


-16299 


1 




Off. Access Mam Memory 


SC054 


49236 


-16300 


1 




Read PAGE? Swilch 


SC01C 


49180 


-16356 


Read 


HIRES 


On: Access High- 












Resolution Page IX 


SC057 


49239 


-16297 


2 




Off: Use RAHRD, RAMWRT 


*C056 


49238 


-16298 


2 




Read mires Switch 


SC01D 


49181 


-16355 


Read 
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Figure 3-4. Effecl oi Switching ALT2P 
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Figure 3-5. E»ect of S*»1ch-ng PAGE2 
with 805TOAE and HIRES On 
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Auxiliary-Memory Subroutines 

If you want lo write assembly-language programs or procedures 
that use auxiliary memory, the built-in auxiliary-memory subroutines 
will be helpful- These subroutines make it possible to use the 
auxiliary memory without having to manipulate the soft switches 
already described. 

The subroutines described in this section make it easier to use auxiliary 
memory, bul Ihey do not protect you from errors You still have to plan 
your use of auxiliary memory to avoid inexplicable crashes 

You use these built-in subroutines the same way you use the I/O 
subroutines described in Chapter 3 of the Apple He Reference 
Manual: by making subroutine calls to their starting locations. Those 
locations are shown in Table 3-4. 



Table 3*4. Auxiliary-Memory Routines 



The carry bit is btl in the processor 
status word: use the SEC instruction to 
wt it. tfiQ CLC to dear IL 



Subroutine 

Name 


Location 


Description 


AUXMOVE 


SC311 


Moves data blocks between main and 
auxiliary memory 


XFER 


SC3U 


Transfers program control between 
main and auxdiary memory 





Moving Data To Auxiliary Memory 

In your assembly-language programs, you can use the built-in 
subroutine named auxmove to copy blocks ot data trom mam 
memory to auxiliary memory or from auxiliary memory to main 
memory. Before calling this routine, you must put the dala 
addresses into byte pairs in page zero and set the carry bit to 
select the direction of the move — main to auxiliary or auxiliary to 
main. 



Warning 

Don't try lo use auxmove to copy dala in page zero, page one (the 
6502 slack), or in Ihe bank-switched memory (SD0O0-SFFFF). 
AUXHOVE uses page zero while it is copying, so it can't handle moves 
in the memory space switched by ALT 2 P. 
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Tibl* 3-5. Parameters to* AUXMOVE 
Routine 




Remember that Pascal uses page zero too. so you can'I use 
AUXMOVE from a Pascal procedure without saving the contents of page 
zero first, and restoring them afterward. 

The pairs of bytes you use for passing addresses to this subroutine 
are called A1 T az, and aa; they are used for passing parameters to 
several of the Apple lie's built-in routines. The addresses of these 
byte pairs are shown in Table 3-5. 



AIL 

A1H 


J3C 
S3D 


A2L 
A2H 


S3E 
53 F 


A4l 

A4H 


5*2 

it! 



Name Location Parameter Passed 

Carry t = Move from matn to auxiliary memory 

= Move Irom auxiliary io mam memoiy 

Source starting address, low-order byte 
Source starting address, high-order byte 

Source ending address low-order byte 
Source ending address, high-order byle 

Destination starting address, low-order byte 
Destination starting address, high-order byte 

Put the addresses of the first and last bytes of the block of 
memory you want fo copy into A1 and A2. Put the starting address 
of the block of memory you want to copy the data to into aa. 

The auxhove routine uses the carry bit to select the direction to 
copy the data. To copy data from main memory to auxiliary 
memory, set the carry bit (sec); to copy data from auxiliary memory 
to main memory, clear the carry bit (CLC). 

When you make the subroutine call to auxmove, the subroutine 
copies the block of data as specified by the a registers and the 
carry bit. When it is finished, the accumulator and the x and v 
registers are just as they were when you called it* 



Transferring Control To Auxiliary Memory 

You can use the built-in routine named xfer to transfer control to 
and from program segments in auxiliary memory. You must set up 
three parameters before using xfer: the address of the routine 
you are transferring to t the direction ot the transfer (main to 
auxiliary or auxiliary to main), and which page zero and stack you 
want to use L 
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Table 3*6. Parameters lor XFER Routine 



Name or 
LociUon 



Parameter Pasted 



The overflow bit is btl 6 in the 
processor status word; use the ClV 
instruction to clear it To set it, force an 
overflow by adding two numbers that 
total more than 127 



Carry 



Overflow 



S3£D 
S3EE 



1 ■ Transfer from main to auxiliary memory 

= Transfer from auxlfeary to main memory 

1 = Use page zero and stack m auxiliary memory 
■ Use page zero and stack *i mam memory 

Program starting address* low-order byte 
Program starting address, high-order byte 



Put the transfer address into the two bytes at locations $3 ED and 
S3EE. with the low-order byte first as usual The direction of the 
transfer Is controlled by the carry bit; set the carry bit to transfer to 
a program in auxiliary memory; clear the carry bit to transfer to a 
program in main memory. Use the overflow bit to select which page 
zero and stack you want to use; clear the overflow bit to use the 
main memory; set the overflow bit to use the auxiliary memory. 

Warning 

II is the programmers responsibility to save the current stack pointer 

somewhere in the current memory space before using xfer and to 

restore it after regaining control. Failure to do so will cause program 

errors. 



After you have set up the parameters, pass control to the x f e r 
routine by a Jump instruction, rather than a subroutine call xfer 
saves the accumulator and the transfer address on the current 
stack, then sets up the soft switches for the parameters you have 
selected and jumps to the new program. 
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Chapter 4 



Programming Examples 



This chapter contains examples showing how to use the auxiliary 
memory Irom a program. These examples are not intended to be 
universal routines that everyone can use as is; rather, they are 
representative examples showing how specific operations have 
been implemented You will probably want to study the examples to 
see how it is done, then copy or modify them to suit your 
application 

Identifying Different Configurations 

By identifying the configuration of the machine they are running on. 
application programs for the Apple He can take advantage of the 
new features and still remain compatible with older Apple ll's. This 
section gives a procedure for doing this from assembly language 
and shows how to use the identification routine in programs written 
In Applesoft BASIC and Pascal. 

The identification routine returns a value to the calling program that 
depends on the type of machine it is running on. Table 4-1 shows 
the return codes. 



Table 4-1. Identification Return 

Codes 



S00 TO) * not an Apple lie 

S20 (32) - Apple He. but no Apple He 80 -Column Text Card 

SCO (64) ■ Apple He with 80 Column Te<\ Card without aurtiary memory 

S80 (128) - Apple He with Extended 80-Column Text Card 
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Note: An 80-column card installed in expansion slol 3 will work in an 
Apple He (he same as in an Apple II or Apple II Plus, but it does not 
activate the built-in 80-column firmware. The identification program does 
not detect such a card, but returns a code of 32. no Apple He 
80-Column Text Card. 

Here is an outline of the procedure Ihe Identification routine uses to 
Identify an Apple lie and its variations: 

1, Save four identification bytes from the ROM RAM area (10000 

tO $FFFF). 

2. Disable interrupts. 

3 Switch bank-switched memory to read ROM by reading JC089 
twice. 

4. Identify Apple He by finding the value 06 at SF8B3 

5. If Apple He. and high bit is on at location SC017, then the 
computer has a text card. 

6. If Apple He with 80-Column Text Card, then check for auxiliary 
memory: 

a. If *C01 3's high bit is on. then reading auxiliary memory so 
must have auxiliary memory. 

b. If 1C01 6's high bit Is on. then reading auxiliary zero page 
so musl have auxiliary memory. 

c. It sparse memory mapping (no upper tour address bits so 
that S800 has the same RAM location as scoo). then no 
auxiliary memory. 

1 . Exchange a section of zero page with ihe section of 
code that switches memory banks. This way the zero 
page data is saved and the program doesn't get 
switched out 

2. Jump lo the relocated code on page zero. 

3. Switch in auxiliary memory (S2Q0 - S8FFF) for reading 
and writing by writing to SC005 and $C003. 

Note: Auxiliary memory locations $400-$800 and 
S2000-S4000 may not be available depending upon 
the setting of soft switches tor 80-column display and 
high-resolution graphics— they have priority over 
auxiliary memory selection. 
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4. Store a value at saoo. and see it same value at scoo 
If not, then auxiliary memory. 

5. Change value at scoo, and see if S800 changes to 
same value If so. then no auxiliary memory. 

6. Set soft switches for reading and writing to main 
memory by writing to SCOO? and SCOOA. 

7. Jump back into program on main RAM 

8. Put zero page back. 

7. Store identification byte for later reference by calling routine 

8. It Pascal routine then turn card back on by reading scoss 
twice. 

9. The BASIC or assembly-language routines resiore the 
RAM ROM area as it originally was by checking tour bytes 
saved at Ihe start of the routine. 

10. Enable interrupts. 

11. Return to caller 

For some applications it may not be necessary to identity the exact 
configuration ot the computer. For example, if your program cannot 
use the auxiliary memory, then you would not need to know 
whether it is available or not. In that case you may want to eliminate 
parts of the routine. For other applications the identification routine 
will use memory space required by your program, so you will need 
to move the routine to some other location. 




Warning 

If you change Ihe identification routine, make sure that it still determines 
the configuration m the same way as the onginal. Later revisions ot Ihe 
Apple He may not support other identification procedures 



Apple He Identification in Assembly Language 

The assembly-language subroutine given here is assembled to 
machine language in locations S2D0 through S3Cf . To call the 
subroutine, your program does a jump to subroutine (JSR) to $2 da. 
When the subroutine returns, the identification code is stored in 
memory location S3CF. 
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Apple 

I9BZ 



lie Identilication Program 



PARAR 

SAFE 

SAVE 



HV 



Oh 



0UT4 



OLiTj 



ourz 



OUT' 



GIG 
ECU 
ECU 
EflU 
PHP 
III 
IDA 
STA 
LDA 
5TA 
LDA 
STA 
LDA 
STA 
LDA 
LDA 
LDA 
CUP 
IRE 
LDA 
ftMt 
LDA 
INI 
LDA 
• HI 
LOT 
LO* 
LOA 
ST* 
5TA 
DEi 
DNE 
JNP 

PUP 
LOT 

LOA 

STA 
DET 

BHE 

PLA 

BC5 

LOA 

STA 
JHP 
LDA 
STA 
JMP 
LDA 
STA 
jMP 

LDA 
5TA 



SZD4 
I3CF 

IO001 

lioo 



SEOOO 

SAyE 

IDOOO 

5AWE+1 

tDCOO 

SAVE+2 

IDBOO 

SAVE-*- 3 

BCQB1 

SC0B1 

IFBBJ 

-S6 

ouri 

SC017 

OUT? 

SC01J 

QUT4 

f C016 

0UT4 

*DONE»START 

S1ART-1,* 

SAFf-1,V 

5AFEM»T 

START-1.Y 

NV 
SAFE 

'DOME-START 

*TART-1,¥ 

SAF£*1,1T 

MV2 

DUT3 

-$eo 

PAMAV 

OUT 

>IfcO 

PARAM 

OUT 

*E2D 

PARAM 
Out 
*0 
PAMM 



;START OF CODE RELOCATED ON PACE ZERO 
;5TART OF FOUR BYTE LANGUAGE CARD ID 
;0I5»8lE INTERRUPTS 

;SA V E t BtTES FROM 
•OMRAM AREA FOR LATER 



;RESTO«ING OF RANRON 
jTO ORIGINAL COND" 



TION 



;EN5uQ£ *rf AD ING RON ftV TURNING OFF 

BANKABLE MEM, 

♦GET APPLE ME SIGNATURE RTTE 

;IF HOT *6 THEN ROT APPUIIE 

[VAS BO COLUMNS FOUND DURING STARTUP 

; tF Nf RIT ON THER NO 80 COLUMN CARD 

;SEE IF AUJt MEMORT BEING REAO 

;AU* MEM BEING U5ID SO AUX MEN AVAIL. 

;SEE IF AUK IP BEING USED 

;AU' ZP BEING USED SO AUX MEM AVAIL 

;R0* SgWE T|T SO KEEP CRICKING 

;$UAP SECTION OF ZP WITH 

;C0DE HEEDING SAFE LOCATION DUPING 

;REAO AUA MEM 



;JUNP TO SAFE GROUND 
;tA(< FROM SAFE GBOuNI 
,-MOVE ZERO PAGE BACH 



SAVE STATUS 



;6ET BACK STATUS 

;CAIR¥ SET SO HO AUX MEM 

;naoe IT SO There IS Au* M(n SET 

;PAUAM'tBO 

;B0 COLUMNS BUT NO AUX SO SET 
;P*SAM-S40 

;APPLE HE BUT NO CARD SO SET 
;PARAM-S20 

;hot an apple he so set param-O 
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■ V*T» 



OUT 


LDA 


SEOOO 




CHP 


SAVE 




6N€ 


OUTON 




LDA 


soooo 




CHP 


5AV£f1 




BN€ 


OUTQN 




LDA 


SD4.00 




CNP 


IAYE+2 




INC 


OUTON 




LDA 


SOBOO 




CNP 


5AVE»3 




ICO 


GOOUT 


OUTON 


LDA 


StOift 




LDA 


SEOOO 




CUP 


SAVE 




1EQ 


OUTONO 




LDA 


ICDSO 




J*P 


GOOUT 


OUTOHO 


LDA 


SDOOO 




CUP 


SAvE+1 




DEO 


OUTON1 




LDA 


SC060 




JNP 


GOOUT 


0U»ON1 


LDA 


SD400 




C*P 


5AVE+? 




BEO 


OUTOR2 




LDA 


1COSC 




jHP 


600UT 


DUIOH2 


LDA 


SDBOO 




CNP 


SAvE+J 




BE5 


GOOUT 




LDA 


SCOfiO 


GOOUT 


PLP 
UTS 




'•• ROUT 


|NC HUN 


IN SAFE AREA 


START 


LDA 


-S« 




STA 


SCO05 




STA 


SC003 




STA 


1800 




LDA 


ICOO 




CNP 


*IEE 




BNC 


AUIHEN 




ASL 


SCOO 




i :* 


SSOO 




CNP 


SCOO 




INI 


AUXNEN 




SEC 






DCS 


BAC* 


AU*NEN 


CLC 




baci 


STA 


SCOOi 




5TA 


H(i: 




JNP 


ON 


oo*E 


HOP 





;If ALL 4 BYTES THE 5AN€ 
gfHI LANGUAGE CARD NEVER 
I WAS ON 50 00 NOTHING 



;N0 NATCH. SO Tu»* F J *> S T 
;SAN4 OF LC ON AND CHECK 



jfF ALL LOCATIONS CNECft 
JTHEH DO NOTHING MORE 
;OThERw!SE TuQN ON BAN< Z 

;CHECK SECOND BYTE IN BANC 1 



^SELECT BANK 2 

JCHECK THIRD BYTE IN BAN* 1 



;SELECT BANK t 
;AE5ET INTERRUPTS 

NOT AFFECTED BY MOVES *•• 

■TRY STORING IN AUK HEN 

; WRITE TO AU< UHlLE ON NAIN ZP 

•SET TO READ AUA RAN 

pCHICK FOR SPARSE WEN MAPPING 

;S£E IF SPARSE NENOHV -5A»E VALUE 

; \t AWAY 

;NAT BE SPARSE HEN SO CHANGE VALUE 
; A SEE WHAT HAPPENS 



;SPARSE NAPPING SO NO AWN HEM 

ITHERE IS AUX HEN 
;SWITCH BACK TO WRITE MAIN RAN 
iSWITCH BAO NAIN RAN READ 
CONTINUE PROGRAM ON PG 3 MAIN RAN 
;END OF RELOCATED PNOGRAN NAflftEft 
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Apple He Identification from BASIC 

One way to identity the configuration of an Apple lie Irom BASIC is 
to load (using bloao) the machine-code version of the assembly- 
language routine described in the previous section, then execute a 
call statement to location 724 ($2D4). When the subroutine 
returns to the BASIC program, executing a peek at location 975 
($3Cf) gets the result. 

Here is another approach to writing a BASIC program to identify the 
type of Apple II it is running on. In this program the assembled 
code lor the assembly-language identification routine from the last 
section is included in the data slalements. 



Apple lie Identification from 

Applesoft BASIC 



10 OAT* 6. 12 0, 171, 0. 2 24 , 1*1 , 208, 2, 173. 0, 208, 141, 509, 2, 173. 0, 

21Z, Ut r 210, 2, 173. 0. 716, 141, 21). 2, 173. 129, 192. 173, 129, 

192, 173. 179. 251. 201, 6, 204. 73. 173 
20 DMA 23, 192, 46. 60. 173. 19. 192, 4ft. 39. 173, 22. 192. 4ft. 34. 160, 42, 

190, 162, 3, 185, 0, 0, 150. 0, 153, 162, 3. 136, 208. 2*2. 76, 1. G. 

8, 160. 42, 1IIS, 162, 3, 133 
30 DATA 0, 0, 136. 208, 24 7, 104. 176, 8, 169. 128, 141, 2 07, 3. 76. 73. 3. 

169, 64. 141 , 207, 3, 76, 73. 3. »69. 32. 141, 207, 3, 76, 73, 3, 169, 

0, 141. 207. 3, 173, 0, 224 
40 DATA 205, ?0S, 2, 208, 24, 173, 0, 208, 205, 209, 2, 208, 16, 173, 0. 212, 

205, 210, 2, 306, 8, 173, 0, 216. 205, 211, 2, 240, 56. 173, 136. 192, 

173, 0, 224. 205. 20ft. 2. 240, 6 
50 OATA 173, 128, 192, 76, 161, 3, 173, 0. 209, 205. 209. 2. 240. 6. 173. 128. 

192, 76. 161. 3, 173, 0, 212, 205, 210, 2, 240, 6, 173. 12ft, 192, 76. 

161. 3, 173. 0, 216, 205, 211, 2 
60 OArn ?40, 3, U3, 128, 192, 40. 96, 169. 238, 141, 5, 192, 141. 3, 192, 

141, 0, 8, 173, 0. 12, 201. 236. 208, 14, H» 0, 12. 173. 0. 6. 205, 0, 

12, 208, 3. 36, 176, 1, 24 
70 OAT A U1, 4, 192. HI, 2. 192. 76. 29. 3. 734 
Bfl AL00K * 975:3TART - ?24 
90 *0R 1 * TO 249 
100 P€A0 6ME 

1 10 poke start + 1.8me 

120 rot 

130 gall start 

140 RESULTS - PEEK MlQOO 

150 PAJflT RESULTS; SEP* RESULTS OF MEAN NOT A HE; 32«EAR5AIIE8uT*0 80 

COLUMNS; 64 MEANS At IE WITH 80 C0LUHN5 8UT HO AuX NE»J 1 28 HEARS AI IE 

WITH AUt MEN 
160 CRD 
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Apple lie Identification from Pascal 

Here is the assembly-language identification program previously 
described in the form of a Pascal procedure. 



Apple 
Pascal 



le Identification Irom 



ret 

SAF 

r 



, MACRO 
PLA 

sn 

PLA 
STA 
AW* 



♦MACRO 

PL* 

OU 

PLA 

PLA 

.ENDM 



.FUNC 
L»RR ,<0U 
E ,EQU 



POP ;SAVt PASCAL RETURN ADDRE55 



PlKL,SI*5 ^ADJUST FOP FUNCTION 



10.0 



G<JG? 



;TfHP STORAGE OF RETURM 10 PASCAL ADDRESS 
;STABT OF CODE RELOCATED Oh PAGE 2ER0 



MV 



POP 

PULL-BIAS 

PHP 

SE1 

LDA 
LDA 
LDA 
CMP 



RETU*> 



LDA 
BHJ 
LDA 
MI 
LDA 
SHI 
ID* 
LDA 
LDA 
SIX 
STA 
DET 



OCI 
0C049 
0PB65 
-6 

ocotr 

OUT? 
0C015 

0UT4 

0C016 

OUT* 

**A 

START-1.Y 

MfE-I.Y 

5AFE-1.T 

5TART-1 ,t 



;tOCK OUT INTERRUPTS 

;E«SURE READING RON BY TURNING Off 

;eAM«ABLE MEM 

;GET APPLE Hi SI ON I TUBE BYTE 

;If NOT -6 THEN NOT APPLE lie 

;HP4 80 COLUMNS fOUNO DURING STARTUP 

;IF IfIGh BIT ON THER NO *0- COLUMN CARD 

;5EE IF AUX MEMORY BEING READ 

;AUK MEM BEING USED SO AUX MEM AVAIL 

;£EE IF AUX Z? BEING USED 

;AUA 2P BEING USED SO AUX MEN AVAIL 

;NOT SURE YET SO KEEP CHECKING 

;SUAP SECTION OF IP WITH 

;CODE NEEDING SAFE LOCATION DURING 

;READ AUI MEM 
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on 



MV2 



: _ T " 



OlHJ 



out; 



outi 



:-«t 



PAfiAn 



tNE 


»v 


JMP 


SAFE 


PHP 




LDT 


**d 


LP* 


STAAT-1.Y 


ITJ 


5AFE-1.Y 


PET 




IfcE 


HV2 


► LA 




BCS 


OD f 3 


IDA 


'SO 


5TA 


PAAftM 


JttP 


OUT 


IDA 


•40 


STA 


PARAM 


JMP 


Out 


LD* 


-20 


sta 


P*»*M 


JMP 


OUT 


IDA 


-0 


STA 


PARAM 


LDA 


OCOAB 


LP» 


ocoei 


PIP 




LDA 


'0 


»PA 




LDA 


PAAAM 


PHI 




tPA 


RETUHN+1 


PHJ 




LDA 


RETURN 


F*A 




IT5 




.BYTE 





;JUMP TO SAFE GROUND 

;BAC( *S0» SAFE GROUND. SAVE STATUS 

|HOVE ZERO PAGE BACK 



;GET RAC< STATUS 

;CABPY 5£T JO NO AUI NEK 

;MADE IT SO THERE IS AUK NEN-5ET 
;PARAH-SB0 

;B0 COLUMNS BUT NO AUX SO Stt 
;PARAMt-SAO 

;APPLE IH PUT HO CARO $0 SET 
;P*N*H-J20 

;NOT AN APPLE II* 50 SET PARAH-0 
;GET PASCAL BACK 

^REACTIVATE INTERRUPTS 

;PUT IN HIGH RYTE OF RESULTS 

;PUT FOUND VALUE I N LOU BYTE a PUSH 

RESTORE PASCAL RETURN ADD 



: ROUTINE RUN IN SAFE AREA NOT AFFECTED BY "OWES 



r, t * b t 



BACK 



OONE 



LOA 
5TA 
5TA 

5TA 
LDA 

CNP 

bnc 

A5L 
LDA 
CMP 
BNF 

sec 

BCS 

CL< 
STA 
STA 

JNP 

NOP 
.€NC 



-DEE 

DC005 

0C0O3 

OBOC 

ocoo 

-DEE 

AUMM£M 

OCOO 
0500 
OCOO 
AUXNEN 

BACK 

OCOO* 
OC002 
ON 



;TRY STORING . IN AUK HEN 
;WRITE TO AUX WHILE ON MAIN 19 
jSET TO READ A V t RAM 
;CHEC< FOR SPARSE MEM HAPPING 

;SEE IF SPARSE NEMOPY-SANE VALUE 

;1< AWAY 

;MA* BE SPARSE MEM SO CHANGE VALUE 
JA SEE WHAT HAPPENS 



•SPARSE NAPPING SO NO AU* WEN 

jTHENE IS AUX MEN 

;5WITCH BACK TO WRITE MAIN RAM 

;SWHCH BACK MAIN flAM REAO 

;C0NT1NUE PROGRAM ON PG 5 NA1N RAM 
;EN0 OF RELOCATED PROGRAM MARKER 
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) 



Hi-Hos Page Mover lot Auxiliary 

Memory Demo. Using auxhove 

Subroutine- July 1982 

pahn » Hi byleol eu*. add»- (Page * 

times 32,. 

Call putpag lo copy Wres graphics 

page lo aux, at", location specitied by 

PARW 

Call 66iP»s to load hues graphics; 
from aux. Nf". locahon specified by 

PA»» 



Storing Graphics Pages from Applesoft 

It is generally not practical to use the auxiliary memory from BASIC 
A BASIC program can only move its variables in memory by getting 
very thcky with peek and poke commands, an approach that is 
both inefficient and dangerous. 

There is one form of data that uses lots of memory and is simple 
enough to handle from Applesoft; high-resolution graphics pages 
The auxiliary memory is an ideal place to store as many as five 
complex graphics pages for rapid loading into the display buffer. 

Like all of these examples, the following Applesoft example 
includes two short assembly-language subroutines. The first listing 
is the assembly- language form of the subroutines. The second 
listing is the Applesoft program with the machine-language 
subroutine included as a series of data statements. This method of 
adding a machine-language subroutine to a BASIC program Is not 
very efficient, but it is convenient for short subroutines 

The program has two phases: in the first, the program generates 
five different high -resolution views and stores them in auxiliary 
memory; in the second, the program loads the stored graphics 
pages back into main memory one after another. 





DSECT 






ORG 


ISC 


SflClEG 


OS 


2 


SOUND 


OS 


2 




OS 


a 


DESTIE6 


OS 
DENO 


2 


» 


EOU 


iZGOQ 


PG1EH0 


EOU 


13FFA 


AUXHOVE 

• 


EOU 


I»»1 




ORG 


$J00 


par* 


OS 


1 



• HQVE HI-RES PAGE TO AUX *EH: 
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PglPAO 



'AKI1 



D=ST 



EflU 


* 


LDA 


•>PG1DE6 


STA 


S&CIEG 


LDA 


-<PG1B£G 


STA 


S*CiEG+1 


LDA 


mpguno 


STA 


S«tE*0 


LDA 


*<PG1END 


STA 


SRCEMO+1 


INAT 


[OR AOORESS 


LDA 


♦0 


5TA 


OlSTfEG 


LDA 


PARR 


*TA 


0E5T«C*1 



;PAGE STARTING 
lADPNESS 



;PAGE ENDING 
;AD0tES5 



;0ESTIHATION 
;PAGE BEGINNING 
;ADDifSS 



• USE AtUHQVE TO DO IT: 



SEC 

JS1 

*T$ 



AUXRQVE 



* COPT MM TO «AJ« NCRO*y 



TOAC 


EQU 


* 






LDA 


OFCUEG 


;DE5TlliATI0B 




STA 


peSTlEG 


IMSE BEGINNING 




LDA 


"PG1BCG 


jADDBESS 




STA 


DESTDtG*1 




PAAM 


• SOURCE AOD*E$Sf S 






LDA 


■0 


;PARN FOR 




STA 


SRCDEG 


fSOURCE BEGINNING 




LDA 


PARR 


;AOOR£SS 




5TA 


SRCBEG+1 






LDA 


-ira 


;CONPUTE SOURCE 




STA 


SRCEND 


;ENOING ADDRESS 




CLC 








LDA 


PARR 






ADC 


-sir 






$1A 


SRC|ND*1 





JS£ AuKHOYE to 00 It: 



CLC 
JSff 



auihqve 
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Gtoto. Hires graphics demortslralion 
for the Apple lie Extended 80 Column 
Te»t C*d 



99 

100 

107 
108 
109 

117 
m 

119 
»?7 

12fl 
1?9 
ISO 
HO 
170 

199 
200 
?10 
220 
230 

299 

500 

510 

520 

550 

5^0 

998 

999 

1000 

lOlO 

1020 

1050 

1040 

199B 

1999 

2000 

2029 

2050 

2040 

2050 

2100 

2120 

29M 

2990 

2999 

5000 

5100 

3200 

5990 

3999 

4000 

4020 

4040 

4059 

4060 

4060 

moo 



1 



HE* 

ren 

R£H 

REM 

REM 

REM 
REN 

REN 

REN 

REN 

REN 

REN 

TfST j 

PRINT 

REN 

REN 

PA*A 

DAT* 

DATA 

OMA 



t h i ■> prog ran draws five vi t«& of m r □ t 4 1 i ng 9 lobe a rt d s 1 o ^ * 1 
five copies of thfH1*ltv*p4ge In lunddry jaeetory* It then 
ao*e* the views **om aval U a^v m«o^ etc* into iht hi^*es 
graphics page in nin e*ea»ort , on* ittef aflo^*r. The *ap'd 
sue cess I on of viens cities the i*pr essi on of a solid 
*Ot *T ing g lobe . 



CHR* f17): REM CTRL-0 for 40-coiumn display 

Pa?er lubrout Ines in machine language: 

169,0*133.60.169,52.155,61,169,248.133,62,169,65.135 

63.169,0,133,66,173,0,5,135,67,56.32.17.195.96,0 

169,0.155,66,169,52,135,67,169,0,133.60,173,0,3,133 

61 ,169. 248, 13 5. 62. 24, 175, 0,5, 105, 51, 153. 63 ,24, 32, IT, 19 1 



REN 
REN 
PA** 



l.itTE 



Read the Pager subroutine? and store at $301x 
766;PuTP»i;E - 769;aRIN0^A0t - BOO 
FOR I - TO 64 
1 READ BYTE 
3 POKE PUTPAG! 
NEI1 I 
REN 

REN Sat up constants for drajajl 

PI ■ 3,14159265:P2 - PI 2 
IP- ■ P2 9: REN angle between tier I 

£P - SP 5i REN starting angle increment betwaen v ♦ *-* 
0? a PI 15; REN regnant swe (angle> for drawing meridians 
B - 1 : REM It|t1-Hj4f i»*S of (II *P*e>. 



i ng aif ndi 



trllipies) 



ins 



v t e*& 



REN 



Loop starring at 2000 draw* fWt nt« and stores ihea): 

foq vieu - 1 to 5 

: ren hgr to e^ese previous view; 

t HON : HCOLOR- 3 

i REN Draw picture fre*ftt 

1 HPL0T 60,0 TO 60,159 TO 219,159 TO 219,0 TO 60,0 

E VTA9 23: HTAI 9 

1 PRINT ...constructing view # ;VtE* 

: «* 

tpp-EP* view: reh different sten ing angle each Ht-M, 

; REN Loop star t mg at 3000 draws aierldi ans (ell t pses) ; 

■ FOR IANGLE * DP TO PI STEP SP 

::* - COS ClJmtU): «€H $e*i-«inpc aai| of #11 ipsa. 

t;FIRSt - 1: REM for plotting 

■E REN 

1 ; REM Loop start) ng at 4000 draws a *er lal an (ell ipse) : 

EE FOI THETA - TO PI STEP QT 

ttf LIT )c ar A * 514 (TNCTA) 

it: LET T * t • COS (tH£*A» 

;:: rem Ne<*t two lines scale 9% and pr for plotting, 

eee LET pi - a * 55 * 140 

::: LET Pf - T • 55 * 60 

EEC IF FIRST THEN NPL0T PH.PYtFIRST -0 
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4110 tt: IF NOT F 111ST THEH HPLOT TO PX.PT 

4200 :: KE*T TKETA 

4300 : «EKT TANGLE 

4400 t YTAI 23: HTAfi 9 

441 t Mill ..^ror^ng vle./;V)£y 

44*9 ; B£« 

45 00 : HEN Pul *»** f" iuM I 1 1 »*¥ Wit'lN 

4510 : P0<E PA**, VIEW * 5? 

4520 : CALL PUTPAGE 

4600 *E1T VIEW 

4689 *£H 

4690 HE* Pi vt U ifilf itces-- now &ho« t^n; 
4700 HOME t VTAi 23 

4720 uTifi 3 i PRINT Leading v itmt f ror auk * 1 1 Rfr f»«ocrv * 

4998 *EH 

4 999 MM lood tear ting at 5D0Q firings VI BUS irom *u«* I ipr? fi»«or* 

5000 *0* VIEW - 1 to 5 

5020 : POKE PARN,V1EW * 32 

5040 : CALL MIKGPAGE 

5060 Htil YIEU 

5997 REN 

599A REN fttpttt «•■« fiv* tfltvfl fOfevffr, 

5999 REN or uPl I I t*e f UEI D ta*n 

6000 GO^O 5000 



Storing Data Strings from Pascal 

These Pascal routines use locations scOO to sbfff in the auxiliary 
memory lor storage and retrieval of strings. 

The code that moves the strings to and from auxiliary memory is 
stored at E ooo in the Extended 80-Column Text Card. A separate 
initialization routine puts this code at eooo, just once T to maintain 
system performance. 

The retrieval routine is very fast roughly equivalent to a MoveLeft 
from a Packed Array of Char. The storage routine is less 
efficient; if speed is important in your program, you may want to try 
to optimize It. 

Uke the other examples, these routines were written for a particular 
application and are not general-purpose subroutines They are included 
Uere to show you the kind of thing you can do with the auxiliary 
memory 
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Auxiliary Memory String Routines 
toy R Ussner 



Thf f el l0»i ng r Out in* *i Mr forced OfHy once. The; rounms chat •ove 
Vt r>ngs * n jr*d out of cfte Ei tended BO-Coluan Tt*i C*rdir» Move J to E*** 

to the *\*iUi*r> «eaorfc . 





.TITLE ASSEMBLY ROUTINES III 




.RACE 






.HOMACROLIST 






.RORATCHUSt 




1 

RDWAlHifi 


.ECU 


LCCO* 


RDAUXtS 


.cau 


0C003 


URMA]H46 


.cou 


OCOOt 


URAUXftB 


.EOU 


ocoas 


RMNAlHlf. 


• eou 


OCOQB 


RUAUX16 


tEQU 


0C009 


hlRESOFF 


.EQu 


0C056 


3 

RETURN0 


.EQU 


028 


HETURNl 


*EQU 


0*A 


1 REGISTER MAP 




J 
ZflEGOO 


.EOU 


4 


ZREG02 


.EOU 


4 


ZffEGO* 


.EOU 


6 


t 

DUTA 


5TA 


RWAuXIfi 




LOT 


-BO. 


OUT4NE0 


LDA 


E0025TUF-1 ,T 




STA 


0E001,Y 




0£i 






■NE 


ODT*»E0 




LDY 


•OFF 


OUT4ME1 


LDA 


EI02STUF-1 ( T 




STA 


0E101 ,Y 




OET 






SHE 


DUT4ME1 




STA 


RWMAmc 




STA 


NIRES0FF 


; EMD OF TH 


IS ROUTINE 





; SOFT SWITCHES. SEE 
; I I? REFERENCE MANUAL 



WRITE AUK MEMORY 
LENGTH QF PATCH 



LENGTH OF PATCH 
CODE NtEDING SAFE LOCATION 



; WRITE HAIR MEMORY 

: MME UlRt* P- AVAILABLE 



Purpose: Move* ■ string fro* *u*t i iery r*emo< v to Peace I - 

If the progrei f Ja-os tne Extended SO-Cotuem r#* i Card, the 
following cade Is loved to E002. 

The pragren get* her* froe a JSR tn MOVE-FR.AUA. «nd goe» beck *G 
that tht iun(i*r> neoory e«n be turned bee* of f * Z«ra pegt on tne 
attended te*t card conttln* ZREG00 end ZREG02; they are tne 
irguitnu for th© *o*e. St eck usage: The rnurr edttrj *s in 48ff i«in 
RCiiory ii ttored in the ium narr itatK » Tnl a 1 s the onlv use o* the 
iui 1 1 iery aeaory *t act* 



Programming Examples 




i 

; 

E002STU* 



EOOZLGQP 



ELM:,: UP 



CLD 

STA *OAUX*S 

LO* -0 

LOft <2RtfOO).T 

USING AU< ZERO PACE 

STA (Z*K02),V 

BEQ E402EXIT 

Taf 

LDA (ZREGOO) ,1 

STA <Z*EGQ2),Y 

PET 

■ME E002LOOP 

STA ROMAJNtS 

RT5 



; READ AUX &ft* 

: reading au< isc 

; WRITING WAIN 4fl* 

j NOT LI«U, BUI P0SS1RLE 



; 3EA0 MAIN 4fl< 

; SOUS RACK TO 4fl« MAN 



F 



Purpo*#: Moves J St ri ng trot PlUAl IC *j * * L » tf'r fie*Ory > 

If the Drogr«n f I nd* ihi Extended 80-CoLutn Tft1 Card* the 
'-j'. '.'jn-ng code 11 Moved to Et02- 

The Drcgrati get* here Iron A JSR tn MOVt.TO.Aux, and goes bach so 
that thi «uo 1 iary atior^ can be turned back Qt t . Zero page on th« 
attended tavt card contain* 2REG00 and ZREGO? exactly as tney are 
found on the N*tn urc cage. 

Stack j sage: The return address in 46 K main m^mo' r i* stored in the 
auxi liarv stack , This is t*e only use of t^e eu»* nary iiaofy 
stacK. 

Mote also that th* au*i If *tf zero oage t s uied for the to and fro* 
addresses. 

ZREG0O: Addr#si of string mat Hants to be storad 

Z a EG 0?: Address of integer that »an ts to *no- wnf rf it .at ttor»rt, 

0»* 'eCii^t r'0000' U no room 
ZREGOfc: Used to *nd«i or faceivlng address 



EKTAVA! -E0U 0E10Z 

1025TUF .«0«0 0C00 

CLO 
X'ff MEANS RESET 8AGR TO BEGINNING. DONE FOR EACH NElf FILE 

LOT -0 

LDA fmG00),Y 

CNP 'OFF 

SNE E102C0 

LOA *0 

STA NE*TAVAI*-1 

LDA #0 

STA NEITAVAI 

DEO E10ZFAU 
CONTINUE HIT* MOMUL ROUTINES 

ilOZCO LOA NE*TAVAI+1 

CHP *0RF 

fiNE E102C1 



; RESET TO SCOO 



; UNCONDITIONAL 



; CtfCU FOR FULL 
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; SPACE 15 FULL. SO RETURN ZERO 

LDA -0 
TAY 

ST* <*AEG0*>,Y 

i«r 

STA UREG021.Y 

BKE E10ZFAU 

; THERE IS STILL ROOK, SO CONTINUE 

E102C1 LDf '1 

SU UREGQil.T 

STA JAEGOWl 

DEY 

IDA IfEKTAvAl 

STA 1ZPEG02) ,T 

5TA Z«E604 

; NOW INCREMENT THE NEKT AVAILABLE ADDRESS 
CLC 





AOC 


*1 




BNf 


*+S 




INC 


NEXTAVAI hi 




CLC 






LOT 


-0 




AOC 


<ZSEG0fl) ( V 




SU 


NE*TAYAJ 




BCC 


• ♦S 




INC 


NEKTAVAI+1 




STA 


VRAUA48 




LOA 


<2REG00),Y 




USING AIM ZERO PAGE 




STA 


<*BEG04),V 




BEG 


E102EKIT 




TAY 




£1 02 LOOP 


LOA 


UREG0O),Y 




STA 


<ZREG0O,Y 




OET 






INE 


E102100P 


E102EXIT 


STA 


WRMAINlft 


Eiomii 


RTS 
.END 





lETURN A ZERO, FULL 



; URCONOl UONAL 



; STORE IN RETURN ADDP 
; SETUP ThE HOVE 



; LOW BYTE OF RETURN 
; HOBE OF ThE HOVE 



; AOO 1 FOR STRING LENGTH 
; ROLLED INTO NEKT PA&E 



; AOO LENGTH OF STRUG 
; PUT IT BACH 

* INTO NEXT PAGE 

; WRITING INTO AU* *«* 

; REA01NG AUK t*ft 

; WRITING MAIN k&K 



; NOW WRITE MAIN MEM 
; GOING BACK TO 48* RAN 



Tkt t0UO*in9 Code 14 linked into th« «iir> P**c«L progrft*. Thtl cod* 
Stores t he erguiients In the lui i I iary *ero o*ge **d tlien jufips to £*•* on 
the Extended BO-Cotuiin Ttit Card. 

-TIUC ASSEMBLY ROUTINES FOR Ml 

.PAQC 

.NOMACBOLIST 

.NOPATCHLIST 



RDHAINtfi 

R0AUI48 

WRNAIN46 

VRAUXIS 

RUAUJM6 

RWNAINU 



-EOU 
.EQU 
.EQU 
-EOU 
<EQU 
,CQU 



OCOOZ 
0C003 
0C004 
0C00S 
0C009 
OCOOfi 



; RETURN ADDRESS ZERO PAGE LOCAT IONS 

RETURNO .EOU 026 

BETURN1 ,EQU 02A 



Programming Examples 




? 



I t j I ': T i S M * ? 



ZREGOO 

: - *: ^ :■ : 



,£OU 

.ecu 



o 

4 



TITLE 

P*QC 



wove smuts mon n« auxiliary memory 
HOVEFRAU,3 



P*0CE&U*€ MOVE-FP,AUX (FNONA; VAR TO*> ** Mow* itrin^ * ) 



Pit root*: *0»t * string f ro» aui I I I §ry Mt»orv to Pa*£*L - M041 0* t m 

# < f .j i > n^/f i-B dont »r iunhir^ fie«ory location £00?- 

Stack usage: Mput , output addresses. 



STORE RETURN ADD* IN AUX ZERO PAGE 

POP BETUNNO J RETURN TO PASCAL 

ADORESSES ARE T«0 BYTES, PULL BOTH BTTE5 OFF T*| MAIN STACK, THEN SWITCH 
TO AUX ZERO PAGE AND 5T0RI BOTH ByTES, 

PL* 



TAX 
PL* 
STA 
STX 
STA 

$TA 



rwauxio 

ZREG02 

JREGQZ+1 

HWMAIH16 



; SHMCH TO AUX ZP 
; IN AUK ZERO PAGE 
; 5TILL IN AUX MEN 
; 5WITCH TO MAIN ZP 



&TOBE FRO* ADDRESS IN AUJ ZERO PA&E 

PLA 

TAX 

PLA 

STA RlfAUXlo 

ST* ZREQOO 

STA Z»f600+1 
NOW GET OVER TO AUK PAGE AND DO IT ALL 

j&B OEOO? 

NOU PROCESS CONING BAC* FROM EDQZ II AUK HEMDRf 

STA RWM1N16 ; NA1N ZP AND TOP 

PUS" AETURNO 

tTS ; BACK TO PASCAL 



; SWITCH TO AUK ZP 
; IN AUX ZERO PAGE 
; STILL IN AUX HEM 



TITLE 
PBOC 



MOVE STRINGS TO He AUXILIARY MEMORY 



PROCEDURE MOVE, TO, AUK (VAR FRONA; VAR TOA) (* «0*» ftrirtg *l 



Puroo**: Move B P*SC*L String to twill try MaNOr*. Nost of thf 
actual *ovt if 3o^# at juiiitarr mtmorf Location ElO?. 



StBGfc usaga; Input, output addrtaaes* 



STORE RETURN ADDB IN AUX ZERO PAGE 
POP RETURN 



: MAIN ZP STACK 
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; NOW STORE TO AO0HE55 IN AUX JERO PAGE 
PLA 
TAX 
PLA 

STA AWAUV16 

STX ZREGOZ 

STA IREGOf+1 

STA RWHAIN16 

; STORE FROM AOORES5 IN AUX ZERO PAGE 
PLA 
TAX 
PLA 

STA RWAUX16 

STX JREfiOO 

STA ZREGOO+1 

; NOV GET OVER TO AUX PAGE AND DO IT ALL 

J5R 0G104 

; RETURN FROH ElOi IN AUX HEHOAT 

STA RWMAIHI6 

PU5H RETURND 
RTS 



; L53 OF AQOR TO NEIlfM 

: KS8 OF AOOR TO RETURN 
; SWITCH TO AUX ZP 
; IN AUX ZERO PAGE 
; STILL IN AUX MEK 
; SWITCH TO MAIN ZP 

; LSB OF INPUT STRING 



; SWITCH TO AUX ZP 
; IN AUX ZERO PAGE 
: STILL IN AUX MEM 



; JUMP OVER NEXTAVAI AT £102 
; MAIN TO NAIN ZP ANO TOP 



E*0 



Programming Examples 




Index 



Index 



accumulator 30. 31 
address bus 7 
address 30 

data 29 

destination starting 30 

program starting 31 

source starting 30 

source ending. 30 

transfer 31 
alternate zero page 25 
AITZP soft switch 25 

figure 27 

table 26 

warning 29 
Annunciator 3 11 

display page used 12 
Apple II 35. 36 

compatibility 25 

system software 15 
Apple II Plus 35. 36 

compatibility 25 
Apple Me viii. 7, 35 

control keys 4 

display memory 18 

display modes 4 

display pages 16 

double high-resolution 
graphics 11-12 

escape sequences 4 

identification from assembly 
language 37 

identification from BASIC 40 

identification from Pascal 41 

Installing card In 3 

processor 4 

Rev A 12 

Rev B 11 
Apple lie Identification 

Program 38-39 
Apple lie Identification Program 

(Pascal) 41-42 

Index 



Applesoft BASIC 17, 35 
program example using 

AUXHOVf 44 
using to store graphics 
pages 43 
application programs viii, 21, 
35 

running wilh the card vii 
assembly language 35, 37 
subroutines 15. 37, 43 
programs to use auxiliary 

memory 29 
routine for Pascal 41 

AUX. CONNECTOR 3 

See also auxiliary slot 
auxiliary memory viii, 4, 7. 9, 

10, 11, 12. 15, 16, 18, 19, 21, 

22, 25, 29. 31. 36, 37 

accessing 4 

address bus 9 

addressing 7 

amount 3 

careless switching 4 

how it works 7-12 

select switches, table 26 

subroutines 29-31 

switching to from bank- 
switched memory 9 

transferring control to 30-31 

using viii 

using from a program, 
examples, 35-51 

warning 9. 15 
Auxiliary Memory String 

Routines 47-51 
auxiliary RAM 15 
auxiliary slot 11 

AUX. CONNECTOR 3 

auxhove subroutine 15, 29, 30 
example using (Applesoft) 44 
parameters 30 
warning 29 







B 

bandwidth, video monitor 11 
bank switches 9 
bank-switched memory 9, 25, 

36 

warning 9 

with auxiliary memory 9 
BASIC 15, 37, 40. 43 

Applesoft 17 

integer 17 

reading soft switches 
from 17 

warning using 15 
bit 29 
bit 7 17 
bit 

carry 29. 31 

color-select 19 

high-order 19, 22, 25 

overflow 31 

sign 17. 22. 25 
built-in 80-column display 

routines 16 
built-in I/O routines 21 
built-in subroutines 29, 30 
bus 

address 7 

data 7 
byte 

high-order 30, 31 

low-order 30, 31 



call statement 15, 40 
carry bit 29. 30, 31 
circuitry, display 18 
CLC instruction 29, 30 
clock cycle 9 

with BO-column display 
on 10 
CLV instruction 31 
color monitor, RGB 10. 11 
color-select bit 19 
commands 

PEEK 17, 43 

POKE 17, 43 
computer configuration, 

identifying 35-37 
configuration 35 
configuration of the 

computer 35-37 
control keys 4 
control switches 22 



D 

data addresses 29 
data bus 7. 11 
data, moving 29 
DATA statements 40, 43 
data strings 46 
decimal 17 
destination starling 

address 30 
display buffer 43 
display circuitry 18 
display cycle 9 
display data 10. 21 
display modes 4 
display pages 16 

control switches 22 

length 9 

locations, table 16 

See also graphics pages 
display soft switches, table 18 
display, 80-column 19 

figure 20 
DOS 3.3 viii, 15. 21 
dot patterns 10 
double high-resolution graphics 

(560 dot) 11-12, 19 

obtaining 11 

board necessary for 12 

with Rev A Apple lie 12 



80-column card, any 36 
80-column display 10, 11. 16, 

19. 36 

addressing directly 18 

bandwidth needed 10 

firmware 3. 4, 36 

figure 20 

map 10 

storing data 9 

switch for 11 

with clock cycles 9 

versus 40-column display (dot 
patterns) 10 
80C01 soft switch 18 
80-Column Text Card 4. 16, 35. 

36 
80-column text 11, 12. 19 

mode 12 
80STORE soft switch 18, 19. 22 

figure 23. 24. 28 

table 26 

warning 21 
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escape sequences 4 
expansion slol 3 36 

Extended 80-Column Text 
Card 11, 35. 46 
buMor 10 
connecting pins 11 
differences from 80-Column 

Text Card viii 
storing data directly 19 



tirmware, 80-column display 

4. 36 
560-dot graphics 11. 12, 16 

See also 280-dot graphics 
40-column text 11 

mode 16 

48K bank, switching 21-22 
48K memory space 9, 21 
14MHz 10. 11 
functions 

keyboard 17. 25 

Pascal 15 



Globe 45-46 

graphics mode, double high- 
resolution 12. 19 

graphics Page ix (high- 
resolution) 19 

graphics pages 43 
storing from Applesoft 43 
See also display pages 

graphics 
280-dot 16 
560-dot 12. 16 
double-high-resolution 19 
double-high-resolution 

memory mappping 19 
high-resolution. Page 1 19, 

22 
high-resolution, Page 1X 19 
high-resolution program 
example 45-46 

H 

hexadecimal 16, 17 

high-level languages 15 
high-order bit 17, 19. 22, 25 
high-order byte 30, 31 
high-resolution graphics 11, 

36, 43 

Page 1 12, 19, 22 

Page 1X 19 



45-46 



pages 43 

program example 

switch for 11 
HIRES soft switch 18. 19. 22 

figure 24, 28 

table 26 

warning 21 
horizontal resolution 



ii 



/ 



identification return codes, 

table 35 
Identification routine 35, 40 

outline 36-37 

warning 37 
Identification, Apple lie 

(assembly language) 37 
identification, Apple lie from 

BASIC 40 
installation 3 
Instruction 

CLC 29. 30 

CLV 31 

JSR 37 

jump 31 

SEC 29. 30 
Integer BASIC 17 
interpreter, warning using 15 
interrupts 36, 37 " 
I/O 7 

links, standard 21 

routines, built-in 21 

subroutines 29 



J5R instruction 37 

jump instruction 31 

jump to subroutine (JSR) 37 

K 

keyboard functions 17, 25 



low bandwidth monitor 19 
low-order byte 30, 31 
low-resolution graphics 11, 16 

M 

machine language 17 

programs 17 
main logic board 

buffer 10 

Rev A 12 

Rev B 11 



Index 




main memory vlH, 7 t 9. 10, 12, 

15, 16, 18. 19. 21, 25. 31 

address bus 9 

switching 4 
memory 

amount card contains vill 

auxiliary 15 
select switches, table 26 

bank-switched 25 

reading 21, 25 

writing 21, 22, 25 
memory locations 17 
Memory Management Unit 7 
memory map 9. 12. 19 

diagram 8 
memory pages, lengih 9 
memory switching 15 
mixed graphics modes 11 
hixeo soft switch 18 
MMU 7 

modes, mixed graphics 11 
Molex-type pins 11 
Monitor program 19 
monitor, low bandwidth 19 
monochrome monitor 11 
moving data 29 

N 

negative decimal 17 

o 

operation 
read 17, 25 

warning with 17 
write 17 T 25 
warning with 17 
overflow bit 31 

p 

Page 1 

display 19 

graphics 22 

high-resolution graphics 12. 
19 

texi 16. 18. 22 
page one 9 

warning 29 
Page IX 

display 16, 18. 19 

high-resolution graphics 19 

text 16 
pages, high-resolution 

graphics 43 
Page 2, text 16 



PAGE2 soft swilch 18, 19, 22 

figure 28 

fable 26 

warning 21 
page zero 9, 29, 30. 31 

warning 29 
parameters 30 
Pascal 30. 35, 37, 41 

1.1 vili. 15 

functions 15 

procedures 15, 30 

routines, programming 
examples 47-51 

storing data strings from 46 

warning using 15 
PEEK 17. 40, 43 
POKE 43. 17 

power-on light 3 

procedures, Pascal 15. 30 

procedures, assembly- 
language 29 

processor 4 

processor status word 29. 31 

program starting address 31 

program 
Apple lie identification 38-39 
Apple lie identification 

(Pascal) 41-42 
Applesoft example using 

AUXM0VE 44 

assembly-language 29 

machine-language 17 

Monitor 19 
programmable memory. 

amount 4 
programming examples 35-51 



RAM 4, 7 

amount 3 

auxiliary memory 15 
RAHRD soft switch 21, 22 

figure 23, 24 

table 26 
rahurt soft switch 21, 22 

figure 23, 24 

table 26 
read operation 17. 25 

warning 17 
reading memory 21. 25 
registers, X and Y 30 
Rev A Apple lie 12 
Rev A main logic board, 

warning 12 
Rev B main logic board 11 
RGB color monitor 10. 11 
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ROM 7, 21 

routine, identification 

outline 3637 
routines, built-in 30 



35, 40 



SEC instruction 29, 30 
7MHz 10 
sign bit 17, 22, 25 
6502 microprocessor 7 
6502 stack 9 
warning 29 
slot 3 36 

solt switches 7. 11, 15, 16, 17. 
29, 31, 37 

accommodating 25 
altzp 25 
figure 27 
table 26 
warning 29 
Annunciator 3 11 
80COL 18 
B05T0RE 18, 19. 22 
warning 21 
figure 23, 24, 28 
table 26 
hires 18. 19, 22 
warning 21 
figure 24, 28 
table 26 
MIXED 18 
PAGE2 18, 19, 22 
figure 28 
table 26 
warning 21 
RAHRD 21, 22 
figure 23. 24 
table 26 

RAHURT 21, 22 

ligure 23, 24 
(able 26 

setting 15-31 

TEXT 18 

warning 17, 21 
software, Apple II system 15 
source ending address 30 
source starting address 30 
sparse memory mapping 36 
slack 25, 31 

warning when switching 15 
slack pointer, warning 31 
standard I/O links 21 
string routines, Pascal 

examples 47-51 
subroutine call 31 



subroutines 
assembly-language 15, 37, 

43 
auxiliary-memory 15, 29-31 
AUXM0VE 15. 29. 30 

parameters 30 

warning 29 
built-in 29 
I/O 29 
XFER 15. 29 

parameters 31 
warning 31 
switch locations 17. 21 

decimal 17 

hexadecimal 17 

negative decimal 17 
switches, control 

48K bank 22 

display-page 22 
system software for the 

Apple II 15 



television set 10, 19 

lext display. 80-column 12. 19 

figure 20 
text Page 1 9. 16. 18, 22 
text Page 1X 16 
text Page 2 16 
TEXT soft switch 18 
transfer address 31 
280-dot graphics 11, 16 

See also 560-dot graphics 



video display page locations, 

table 16 
video displays 16 
video monitor 10 
video display generation 11 

W 

write operation 17, 25 

warning 17 
writing memory 21, 25 

x 

X and Y registers 30 
XFER subroutine 15, 29. 30 

parameters 31 

warning 31 

z 

zero page 25, 29. 36 f 37 
warning when switching 15 



Index 










I 
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Schematic Diagram 
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